home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 4,101 to 4,200 / aol-file-protocol-4400-4101-to-4200.zip / AOLDLs / ADV - Articles & Misc / Manual for ProDev DDT8_DDT16 / DDT.MANUAL.bxy / DDT.Manual / CHAPTER.2 (.txt) < prev    next >
AppleWorks Document  |  1993-08-05  |  9KB  |  166 lines
  1. O=====<====<====<====<====<====<====<====<====<====<====<====<====<====<====<===
  2. O=====<====<====<====<====<====<====<====<====<====<====<====<====<====<====<===
  3. CHAPTER 2
  4. GETTING STARTED
  5. FAST START
  6. HThe procedure to follow when using the ProDev DDT might be something as 
  7. follows:
  8. The ProDev DDT card must be initialized after powering up the computer. B
  9. @If you are using the DDT16 you may use the Init provided on the L
  10. Jaccompanying disk to automatically initialize the DDT during a GSOS boot. A
  11. ?See the instruction provided in the "read.me" file for further 
  12. information.
  13. CYou may also initialize the DDT manually by getting into the Apple L
  14. Jmonitor, (from a BASIC prompt type "call -151" or "mtr") and entering the I
  15. Gcommand "Cn00G", where 'n' is the slot number the DDT is installed in. J
  16. HUsing the commands "PR#n", "IN#n", "n<ctrl>P", etc. will also start the ;
  17. DDT but they disable any DOS hooks and should be avoided.
  18. GIf you enter the ProDev DDT via "Cn00G", you can enter "QU" at the DDT (
  19. prompt to return to the Apple monitor.
  20. WINDOWS
  21. After starting the ProDev DDT you will see a windowed 80 column display.
  22.          _________________________________________5
  23.         |                    |                    |5
  24.         |                    |         2          |5
  25.         |                    |                    |5
  26.         |                    |--------------------|5
  27.         |                    |      |         |   |5
  28.         |                    |      |         |   |5
  29.         |         1          |   3  |    4    |   |5
  30.         |                    |      |         |   |5
  31.         |                    |      |         | 5 |5
  32.         |                    |      |---------|   |5
  33.         |                    |------|         |   |5
  34.         |                    |      |         |   |5
  35.         |                    |   6  |    7    |   |5
  36.         |                    |      |         |   |5
  37.         -------------------------------------------
  38. WINDOW #1
  39. HInformation from Tracing, listing, mini-assembler etc., is displayed in K
  40. Ithis window. The flashing cursor that is awaiting your input, also known 3
  41. as the command prompt, is usually in this window.
  42. WINDOW #2
  43.  M = STK REA WRI LNG BNK PG2 80S CXR   { pseudo register%
  44.      MNE MNE MNE ROM  2  OFF OFF ON
  45.  KEY BRK TYP SAV TXT MIX HGR 80C ALT   { state flags&
  46.  93  OUT C02 ON  ON  OFF OFF OFF OFF
  47. IThe first 2 lines of window 2 contain the current state of the (M)achine D
  48. Bstate pseudo register. M is not really a physical register in the J
  49. Hprocessor, rather it is a pseudo register that is created by the ProDev C
  50. ADDT. The M register is also displayed along with the processor's I
  51. Gregisters when tracing or displaying registers. The Apple IIGS monitor J
  52. Halso contains an M pseudo register which is similar, but not identical, !
  53. to the ProDev DDT's M register.
  54. CThe meaning of the M state register bits from left to right are as 
  55. follows:
  56. STK = reflects the state of the ALTZP switch ($C016)5
  57.       MNE = main memory  AUX = auxiliary memory (*)
  58. REA = reflects the state of the RAMRD switch ($C013)5
  59.       MNE = main memory  AUX = auxiliary memory (*)
  60. WRI = reflects the state of the RAMWRT switch ($C014)5
  61.       MNE = main memory  AUX = auxiliary memory (*)
  62. LNG = reflects the state of the language card switch ($C012)8
  63.       ROM = Autostart ROM  RAM = language card RAM (*)
  64. BNK = reflects the state of the LC bank switch ($C011)*
  65.       1 = bank #1 in  2 = bank #2 in (*)
  66. PG2 = reflects the state of the PAGE2 switch ($C01C),
  67.       OFF = Page 2 off  ON = Page 2 on (*)
  68. 80S = reflects the state of the 80STORE switch ($C018)=
  69.       OFF = use RAMRD, RAMWRT  ON = access display page (*)
  70. CXR = reflects the state of the SLOTCXROM switch ($C015)?
  71.       OFF = Slot ROM at $Cx00  ON = Internal ROM at $Cx00 (*)
  72. FThe bottom two lines of window 2 contain the current state of various >
  73. flags and switches.  From left to right they are as follows:
  74. EKEY = shows the current ASCII key code (with high bit set) that will ?
  75. =interrupt the ProDev DDT while Tracing or Executing multiple >
  76. instructions. The default setting is $93 which is Control-S.
  77. BRK = indicates if real breaks are present in the target program.4
  78.       OUT = no real breaks  IN = real breaks exist
  79. ITYP = indicates the type of processor the ProDev DDT is set to recognize 0
  80. when assembling or disassembling instructions.?
  81.       02 = 6502  C02 = 65C02  802 = 65802{8}  816 = 65816{16}
  82. SAV = reflects the state of the ProDev DDT's "Text Screen Save" mode.2
  83.       ON = screen save on  OFF = screen save off
  84. TXT = reflects the state of the TEXT switch ($C01A).=
  85.       OFF = text mode off (graphics)  ON = text mode on (*)
  86. MIX = reflects the state of the MIXED switch ($C01B).9
  87.       OFF = full page graphics  ON = mixed txt & gr (*)
  88. HGR = reflects the state of the HIRES switch ($C01D).7
  89.       OFF = lo-res graphics  ON = hi-res graphics (*)
  90. 80C = reflects the state of the 80COL switch ($C01F).;
  91.       OFF = 40 column display  ON = 80 column display (*)
  92. ALT = reflects the state of the ALTCHARSET switch ($C01E).<
  93.       OFF = Apple ][ char set  ON = alternate char set (*)
  94. (*) is the state when the switch is greater than 128 ($7F).
  95. WINDOW #3
  96. GThe contents of twelve memory locations are displayed as a hexadecimal J
  97. Hnumber and equivalent ASCII character. The addresses are specified by a 9
  98. two digit bank number followed by a four digit address.
  99. WINDOW #4
  100. IThe current location of the Hardware Breakpoint (if any) is displayed at D
  101. Bthe top of this window followed by the ten most recently accessed L
  102. JBreakpoints.  See "HB" & "SB" for a further description of the breakpoint     
  103. format.
  104. WINDOW #5
  105. IAn area of the system stack RAM is displayed around the current location 1
  106. of the stack pointer which is indicated by "<".
  107. WINDOW #6
  108. HThis is the effective address window. The actual address that a program E
  109. Cinstruction is referring to is not always obvious. For example LDA F
  110. D($34),Y. When tracing or disassembling instructions, the ProDev DDT L
  111. Jcalculates the effective address and displays its contents in this window L
  112. Jsurrounded by the two locations above and below. The effective address is 
  113. indicated by "<". 
  114. DThe ASCII equivalent of each locations hexadecimal contents is also 
  115. displayed.
  116. I{DDT8} - The current settings of the systems various memory switches are G
  117. Eused to calculate if the address is in main or auxiliary memory. The 6
  118. corresponding bank number (00/ or 01/) is displayed.
  119. WINDOW #7
  120. EThis is the protection window. You may specify three types of memory B
  121. @protection in any of six address ranges. See "PW" for a further 
  122. explanation.
  123. STEPPING CODE
  124. HStepping a program is very simple. Let's assume you would like to start L
  125. Jstepping a program beginning at memory location $800. The first thing you J
  126. Hneed to do is set the program counter to point to location $800. You do J
  127. Hthis from the ProDev DDT by using the command "PC=". To set the program 0
  128. counter to $800 you would enter the following:
  129. :PC= 800
  130.  <cr>  or 
  131.  PC= $800
  132.  <cr>  "dollar sign is optional".
  133. BIf you want to see the instruction at location $800, use the "DR" %
  134. command. For example with the DDT8:
  135.  <cr>@
  136. A=00 X=00 Y=00 S=E0 M=0A L=0 P=--1----C
  137.        <--- displayed6
  138. 00/0800:EA          NOP
  139.                        <---
  140. GThe first line of the display contains the contents of the accumulator I
  141. G(A=00), X
  142. index (X=00), Y index (Y=00), stack pointer (S=E0), M pseudo I
  143. Gregister (M=0A), language card condition (L=0) and the status register L
  144. J(P=--1----C). For a detailed description of these registers, refer to the L
  145. J"DR" command in Chapter 5. The second line displayed shows the address of A
  146. ?the program counter, including the bank number (00/0800:), the I
  147. Ghexadecimal form of the instruction (EA), and the instruction mnemonic 
  148. (NOP).
  149. GTo begin stepping you would use the "ST [N]" command. If you wanted to >
  150. step one instruction and stop you would enter the following:
  151.  <cr>  or 
  152.  ST 1
  153.  <cr> "One is assumed if no number entered".?
  154. A=00 X=00 Y=00 S=E0 M=0A L=0 P=--1----C
  155.       <--- displayed5
  156. 00/0801:EA          NOP
  157.                       <---
  158.     <--- The new prompt indicates "Trace/Step" mode.
  159. FThe registers displayed reflect any changes caused by the instruction D
  160. Bjust stepped. The new program counter is displayed along with the *
  161. instruction that would be executed next.
  162. GWhen the ProDev DDT is in the "Trace/Step" mode, pressing the "Return" I
  163. Gkey will cause the instruction pointed to by the program counter to be G
  164. Etraced or stepped. The "Trace/Step" mode is disabled by entering any 
  165. other command.
  166.